home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DISK / EZDC10A.ARJ / EZDC10A.DOC next >
Text File  |  1991-12-23  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   Easy Catalog
  7.                                     (c) 1991
  8.                                   version 1.0A
  9.                                 by Dean L. Wiley
  10.                              1613 Chelsea Road #346
  11.                               San Marino, CA 91108
  12.  
  13.  
  14.          Easy Catalog is just what the name says.  As easy as  you  are
  15.          reading this  documentation,  you  could  be  cataloging  your
  16.          disk(ettes).
  17.  
  18.          Commands for Easy Catalog
  19.          There are no command line options or "hidden" commands  within
  20.          the program (yet).  Everything is put on  screen  -  prompting
  21.          you for actions instead of waiting for a function key or  what
  22.          not.
  23.  
  24.          Running Easy Catalog
  25.          If you are in the directory where the file EZDC10A.EXE exists,
  26.          or if it is in  any  directory  indicated  by  your  DOS  PATH
  27.          statement, simply type EZDC10A to run the program.  Then  just
  28.          follow the prompts to get your disk(ette)s cataloged.
  29.          Please Note:   Easy  Catalog  uses  extensive  temporary  file
  30.          swapping to generate it's output.  If you use a  floppy  drive
  31.          as the output drive it could take a long time to process  each
  32.          disk.  Ram Drives are always the fastest  place,  but  a  hard
  33.          drive is recommended.
  34.  
  35.          (I recommend renaming EZDC10A.EXE to EZDC.EXE for ease of use.
  36.          If you don't understand renaming conventions, consult your DOS
  37.          manual or just type EZDC10A when you want to run the program.)
  38.  
  39.          The file CATALOG.TXT that is the  only  output  file  of  Easy
  40.          Catalog  is  a  standard  ASCII  text  file.   There  are   no
  41.          formatting or special characters contained  within  the  file.
  42.          After cataloging, rename the file or print  it.   I  recommend
  43.          renaming in case you want to make changes (you'll have to  use
  44.          some kind of editor for that, I didn't build changing into the
  45.          program).  IF YOU DO NOT RENAME THE FILE IT  WILL  BE  DELETED
  46.          THE  NEXT  TIME  EASY   CATALOG   IS   RUN!!    This   program
  47.          automatically uses the file name "catalog.txt" for output, and
  48.          does not care if that file  already  exists.   You  have  been
  49.          forewarned.
  50.  
  51.          Easy Catalog can be used to catalog hard  drives  as  well  as
  52.          floppies, this function  being  useful  for  virus  protection
  53.          (identifying changed file sizes, dates, times),  or  just  for
  54.          record keeping.
  55.  
  56.                       ---The Output File (catalog.txt)---
  57.  
  58.          Because this program was written to be a simple and  fast  way
  59.          to catalog  disks,  there  is  no  edit  or  revise  functions
  60.          available for your catalogs.  The  easiest  way  to  update  a
  61.          catalog if you have made changes to a disk in that catalog  is
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.          to run a DOS DIRectory of the disk,  redirecting  output  (see
  73.          your DOS manual if you don't understand output redirection) to
  74.          a file.  Then use your editor to  "CUT"  or  "COPY"  the  file
  75.          listing from that file,  load  the  catalog,  and  "PASTE"  or
  76.          "INSERT"  the  listing  in  the  appropriate  place   in   the
  77.          CATALOG.TXT file.
  78.  
  79.          The output file (catalog.txt) is formatted  in  the  following
  80.          fashion:
  81.  
  82.                                 Name of Catalog
  83.          -------------------------------------------------------------
  84.                   Disk Number xx of catalog [name of catalog]
  85.                       Volume of disk (as reported by DOS)
  86.                  (Disk Comment: [if enabled, as keyed by user])
  87.  
  88.          [dir]                        filename ext   size   date   time
  89.            |                  (Comment: [if enabled, as keyed by user])
  90.            |this is the directory on the disk the file is located in.
  91.  
  92.  
  93.  
  94.  
  95.          Revision (version) 1.0A notes:
  96.          Version 1 did not have the ability to  comment  a  DISK,  this
  97.          function has now been added.  I found  out  a  day  late  (and
  98.          always a dollar short) that DISK COMMENTING would  be  a  good
  99.          idea because of the number of  software  backup  disks  people
  100.          own.  (I am still amazed that I got this tip from a  user  the
  101.          same day I uploaded version 1.00 to a  bulletin  board.)   Now
  102.          there is a prompt asking  if  you  would  like  to  have  DISK
  103.          commenting enabled.
  104.  
  105.          Version 1.0A executable file was compressed using PKLITE  113.
  106.          Forgive any wrongs you may find,   I  tested  this  compressed
  107.          program on a 286 and a 386 cataloging all of: 3.5  inch  disks
  108.          (both sizes), 5.25 inch disks (both sizes), 2 MFM hard  disks,
  109.          1 IDE hard disk (3  partitions),  and  a  CDROM;  without  any
  110.          trouble.  ** I can't afford to register my copy of PKLITE,  so
  111.          please, if you use this program, be merciful and send whatever
  112.          amount of money you think it deserves.  I am also open to  any
  113.          comments, suggestions, etc regarding the software. **
  114.  
  115.          This  program  is  no  longer   FREEWARE,   please   see   the
  116.          "registration information" below for details.
  117.  
  118.                                    ----------
  119.  
  120.          Why this program was created:
  121.          I have tried to use several disk cataloging software packages,
  122.          and none of them  did  things  the  way  I  wanted.   My  main
  123.          interests were:
  124.               1. Being able to see what subdirectory a file lives in;
  125.               2. file sizes and  dates  for  comparison  (good  if  you
  126.          suspect a virus);
  127.               3. Comments;
  128.  
  129.                                       -2-
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.               4. The ability to print or edit the  listing  whenever  I
  139.          felt like it.
  140.  
  141.          How long and what this program was made in:
  142.          Easy Catalog  was  written  in  QuickBasic  version  4.5  from
  143.          Microsoft.  It took all of 3 days (nonconsecutive)  to  write.
  144.          The source code is MS-DOS 5.00 Qbasic compatible,  so  if  you
  145.          are a budding Basic language programmer  and  would  like  the
  146.          source, send me a  letter  and  we'll  see  what  we  can  do.
  147.                    (Revision 1.0A was a 15 minute addition.)
  148.  
  149.                        -----Registration Information-----
  150.  
  151.          This is copyrighted software.  I am releasing it as SHAREWARE,
  152.          which means that I do not expect prepaid  money  for  it,  but
  153.          neverfear - if you continue to use this software for more than
  154.          a trial or evaluation,  registration is not only required  but
  155.          also moral.  It may please you to know this:  I get  extremely
  156.          angry  about   Shareware   authors   offering   slim   program
  157.          improvements and a free upgrade for the user sending  $xx  for
  158.          registration.  This software is complete, and this is the only
  159.          documentation I have for it.  I will consider any US  currency
  160.          as a registration.  For that registration  you  will  receive:
  161.          the conscious knowledge that you are a good person!  I have no
  162.          preconceived rules regarding a monetary value on software that
  163.          is distributed as Shareware.  If you use this program  once  a
  164.          year for archiving your disks, then I would say you get  about
  165.          $1 use from it per year, wouldn't you?  Please, you  know  the
  166.          routine...I've spent  many  late  hours  learning  programming
  167.          languages, and many more hours in developing  this  particular
  168.          program...if you use it, pay for it.   (Don't  think  I  won't
  169.          cash a 1 cent check either!!)
  170.  
  171.          Anyone sending more than $10 will be entitled to version 2  of
  172.          the software mailed to them.  The planned enhancements for  V2
  173.          are: color, multiple  catalogs  based  on  the  catalog  name,
  174.          internal print functions, and any user requested  enhancements
  175.          I can add cheaply before mid-February 1992.
  176.                           Send registration money to:
  177.                                  Dean L. Wiley
  178.                              1613 Chelsea Road #346
  179.                             San Marino, Calif. 91108
  180.  
  181.  
  182.          Shareware distributors please note:  I would appreciate notice
  183.          if you distribute this software, but there are no other  rules
  184.          regarding it than: keep the .EXE and the .DOC together please.
  185.          There is no fee to Shareware  distributors  for  use  of  this
  186.          software, registration will be considered paid.
  187.  
  188.                           -----Legal Information-----
  189.          SHORT FORM DISCLAIMER: I AM NOT  RESPONSIBLE  FOR  YOUR  DATA,
  190.          YOUR DAMAGES, YOU HAIR LOSS, OR ANYTHING ELSE  THAT  MAY  COME
  191.          YOUR WAY, REGARDLESS IF MY SOFTWARE WAS INVOLVED OR  NOT.   WE
  192.          MUST ALWAYS PLAY AT OUR OWN RISK!
  193.  
  194.  
  195.                                       -3-
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.          LONG FORM DISCLAIMER: IN NO EVENT SHALL THE AUTHOR  BE  LIABLE
  205.          FOR LOST PROFITS OR FOR ANY INDIRECT,  CONSEQUENTIAL,  SPECIAL
  206.          OR INCIDENTAL DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE
  207.          USE OF THE LICENSED SOFTWARE OF FROM THE INABILITY TO USE  THE
  208.          SOFTWARE FOR ANY PURPOSE EVEN IF THE AUTHOR HAS  BEEN  ADVISED
  209.          OF THE POSSIBILITY OF SUCH DAMAGE.
  210.  
  211.                          -----Personal Information-----
  212.  
  213.          I am a computer technician/programmer, looking for  that  good
  214.          ole American Opportunity to come my way.   If  you  happen  to
  215.          have  a  use  for  a  computer  technician/programmer,  please
  216.          contact me.  I  have  done  the  bulk  of  my  programming  in
  217.          Microsoft's QuickBasic, and am now switching  to  C  for  game
  218.          creation and portable code.  I am looking for  programmers  to
  219.          help me  get  some  games  done,   please  write  if  you  are
  220.          interested.  I have run and would like to  run  again  a  free
  221.          bulletin board system  --  this  costs  money,  and  is  where
  222.          registrations could possibly go.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                       -4-
  262.  
  263.  
  264.  
  265.